WX1860 B版本 系列芯片固件发布手册

#############################################################
# 网迅千兆网卡固件1001c

发布时间：2025年9月15日
--------------
## 一、版本说明

网卡固件（image）版本： 1001c （B版芯片）

内部组件版本：

| 内部组件             | 版本号 | 补充说明                                     |
| -------------------- | ------ | -------------------------------------------- |
| PXE-UEFI: UNDI       | 1.5.1 | 用于支持UEFI方式PXE启动 UNDI，以下简称 【U】 |
| PXE-BIOS: Legacy     | 1.1.9   | 用于支持Legacy方式PXE启动，以下简称 【L】    |
| FW                   | v1.5.9 | 在网卡芯片上的程序，以下简称【F】            |
| 固件生成工具         |        | 基础配置相关，PCI 等，以下简称【T】          |
| linux/windows driver |        | 驱动，以下简称【D】                          |

## 二、适配平台

适用于网迅芯片型号
WX1860A4*、WX1860A2*、WX1860A1*、WX1860AL*

## 三、新增功能
- 【F】ncsi oem command增加获取vpn pn命令。

## 四、 问题修复 & 优化
- 【F】优化pcie 降lane patch。
- 【F】修复网口link down时，带外NCSI返回网口速率为10M的问题。
- 【F】修复lldp on的网口能收到lldp报文的问题。
- 【F】修复wxtool读cab寄存器只读0口的问题。
- 【F】修复ARP攻击后，NCSI和MBOX通信异常问题。
- 【F】使用PTOS模块替代RTOS模块。
- 【F】WOL功能wake io拉低时间默认设置为2s。
- 【F】移除非NCSI固件定期访问裕泰phy的行为。
- 【F】SMBUS ARP功能适配海光4号机型。
- 【F】标卡NCSI命令流程优化，仅支持NCSI信息查询命令。
- 【F】完善smbus tx超时之后的处理流程，修复smbus scl异常问题。
- 【F】合入fw reset流程，支持烧录固件后不重启生效的功能。
- 【F】WOL功能增加veto保护和lan on保护。
- 【F】优化smbus参数，增加毛刺过滤功能。
- 【F】移除LLDP TX打印。
- 【U】修复HII显示错误的芯片类型
- 【U】修复BIOS下开启vlan，千兆pxe启动失败
- 【L】修复了网卡存在相同mac时导致机器卡死的问题。
- 【T】修改Devcap: MaxPayload 128 bytes 修改成 512 bytes。

## 五、已知问题
    无。

#############################################################
# 网迅千兆网卡固件1001b

发布时间：2024年4月11日
--------------
## 一、版本说明

网卡固件（image）版本： 1001b （B版芯片）

内部组件版本：

| 内部组件              |  版本号  | 补充说明                                       |
| -------------------- |  ------ | --------------------------------------------  |
| PXE-UEFI: UNDI       |  1.5.0  | 用于支持UEFI方式PXE启动 UNDI，以下简称 【U】       |
| PXE-BIOS: Legacy     |  1.1.8  | 用于支持Legacy方式PXE启动，以下简称 【L】          |
| FW                   | v1.5.6  | 在网卡芯片上的程序，以下简称【F】                  |
| 固件生成工具         |         | 基础配置相关，PCI 等，以下简称【T】                |
| linux/windows driver |         | 驱动，以下简称【D】                              |

## 二、适配平台

适用于网迅芯片型号
WX1860A4*、WX1860A2*、WX1860A1*、WX1860AL*

## 三、新增功能
- 【F】增加对SMBUS read操作的处理。
- 【F】增加FW处理ARP命令的流程，可同时支持SMBUS固定地址和SMBUS ARP地址寻址功能，固件可在多平台通用。
- 【F】增加NCSI over RMII升级固件IMG的功能，提供OEM Command 给BMC。（暂未和BMC适配）
- 【F】增加JL2201 PHY and RTL8211F PHY and XZP211FS PHY OEM tool（v1.2.0及以上版本）修改LED功能。
- 【F】增加对裕泰8521、裕泰8531 PHY的NCSI和WOL支持。
- 【F】NCSI OEM 命令增加获取VPD SN。
- 【U】支持FMP协议获取固件版本号

## 四、 问题修复 & 优化
- 【F】增加MBOX cmd，0xF4 reload shadow ram, 0xF5 get lldp status。
- 【F】移除部分驱动/wxtool不使用的MBOX cmd。
- 【F】提供给驱动控制WOL功能开关：通过修改Psr_wkup_ctl BIT1实现。
- 【F】将SPI clock更改为GPIO默认设置
- 【F】优化NCSI命令处理流程，减少报文复制操作。
- 【F】增强网卡NCSI功能在多平台的适配性。
- 【F】SMBUS 固定地址可由OEM tool（v1.2.0及以上版本）修改。
- 【F】优化SMBUS 消息处理流程。
- 【F】flash lock 和unlock 增加锁保护，修复部分场景下烧录失败的问题。
- 【F】移除固件中需要频繁读取FLASH的流程，只在上电时获取一次。
- 【F】变更VPD 在FLASH中的存储位置(由IMG决定)。
- 【F】增加对裕泰8521 8531系列phy的支持范围。
- 【F】修复看门狗异常打印问题。
- 【F】修复带辅电的卡，在LLDP功能关闭时，host poweroff后网口link down的问题。
- 【F】修复10018版本及之后的版本，只带wol后缀的固件，百兆速率下服务器无法被唤醒问题。
- 【F】修复驱动加载后， BMC通过smbus获取link时，link不更新的问题。
- 【F】修复NCSI消息 payload length和reason、code字节序不正确问题。
- 【L】修改Bios 界面设备选项名称。
- 【L】修改流程，对于内部phy不再对phy进行配置。
- 【L】legacy驱动加载时，更新网口link状态给固件。
- 【U】修复裕太phy sgmii模式pxe不通的问题。
- 【U】undi驱动加载时，更新网口link状态给固件。
- 【U】修改非GPIO控制光模块固件的gpio_0模式，由默认输出改为默认输入。
- 【T】去掉SMBUS ARP置位，不再设置是否是固定地址。
- 【T】各个网口配置completion TimeoutDis+。
- 【T】VPD区域中的PN除定制固件外默认改为网卡型号。

## 五、已知问题
   无。

#############################################################
# 网迅千兆网卡固件1001a

发布时间：2023年6月16日
--------------
## 一、版本说明

网卡固件（image）版本： 1001a （B版芯片）

内部组件版本：

| 内部组件             | 版本号 | 补充说明                                     |
| -------------------- | ------ | -------------------------------------------- |
| PXE-UEFI: UNDI       |undi1.4.1| 用于支持UEFI方式PXE启动 UNDI，以下简称 【U】 |
| PXE-BIOS: Legacy     |1.1.6| 用于支持Legacy方式PXE启动，以下简称 【L】    |
| FW                   | v1.5.1.1 | 在网卡芯片上的程序，以下简称【F】            |
| 固件生成工具         |        | 基础配置相关，PCI 等，以下简称【T】          |
| linux/windows driver |        | 驱动，以下简称【D】                          |

## 二、适配平台

适用于网迅芯片型号
WX1860A4*、WX1860A2*、WX1860A1*、WX1860AL*

## 三、新增功能

## 四、 问题修复 & 优化
- 【F】优化wol报文处理流程
- 【F】wol wake io拉低时间，支持通过oem tool定制
- 【F】以实际物理mac地址为源mac发送LLDP报文
- 【F】支持根据Subsystem ID定义的port number来动态分配FIFO空间大小
- 【F】合入pcie 降lane问题解决方案
- 【L】修复了先运行uefi驱动再运行legacy驱动无法收发包的问题
- 【L】修复了legacy驱动作为第一启动项在部分系统上无法退出进行下一启动项的问题
- 【T】支持固件三合一
- 【T】同步降lane问题解决方案

## 五、已知问题
   无。


#############################################################
# 网迅千兆网卡固件10019

发布时间：2023年2月28日
--------------

## 一、版本说明

网卡固件（image）版本： 10019 （B版芯片）

内部组件版本：

| 内部组件             | 版本号 | 补充说明                                     |
| -------------------- | ------ | -------------------------------------------- |
| PXE-UEFI: UNDI       |undi1.4.1| 用于支持UEFI方式PXE启动 UNDI，以下简称 【U】 |
| PXE-BIOS: Legacy     |1.1.5| 用于支持Legacy方式PXE启动，以下简称 【L】    |
| FW                   | v1.5.0 | 在网卡芯片上的程序，以下简称【F】            |
| 固件生成工具         |        | 基础配置相关，PCI 等，以下简称【T】          |
| linux/windows driver |        | 驱动，以下简称【D】                          |

## 二、适配平台

适用于网迅芯片型号
WX1860A4*、WX1860A2*、WX1860A1*、WX1860AL*

## 三、新增功能
- 【F】增加支持NCSI over MCTP over SMBUS、MCTP over SMBUS。注：标卡需要PCB 04版本以上才支持。
- 【L】增加了ipxe对yt8521s光口的支持

## 四、 问题修复 & 优化
- 【F】增加NCSI OEM command，支持获取SN、获取LLDP状态、使能LLDP、获取芯片温度、获取VPD信息。
- 【F】支持YT8531s PHY LED配置，支持对裕泰 PHY LED闪烁频率配置
- 【F】修复Marvell PHY LED Link异常问题。
- 【F】修复千兆网卡subsystem id丢失（全F时）后无法通过mbox解锁flash，从而导致无法在线烧录的问题
- 【F】修复千兆网卡出现的降速问题。
- 【F】NCSI command get version id返回值优化，支持获取 PCI ID
- 【F】NCSI 命令处理流程优化。
- 【F】ethtool可通过mbox接口开关LLDP TX功能。
- 【F】移除可信网络测试代码，风险规避
- 【U】修复乐研光口卡UNDI驱动GPIO不使能光模块问题
- 【U】同步linux驱动中marvell和裕泰外部phy的配置代码到undi驱动
- 【U】按照phy类型区分efi
- 【T】新增备份功能，支持中断烧录
- 【T】将gen1固件linkcap的打印显示问题x8改为x4
- 【T】支持lldp和smbus arp
- 【T】添加pci id指针的备份

## 五、已知问题

无


#############################################################
# 网迅千兆网卡固件10018

--------------

## 一、版本说明

网卡固件（image）版本： 10018

发布时间：2022年5月5日

内部组件版本：

| 内部组件             | 版本号 | 补充说明                                     |
| -------------------- | ------ | -------------------------------------------- |
| PXE-UEFI: UNDI       | v1.4.0 | 用于支持UEFI方式PXE启动 UNDI，以下简称 【U】 |
| PXE-BIOS: Legacy     |  1.1.3 | 用于支持Legacy方式PXE启动，以下简称 【L】    |
| FW                   | v1.4.2 | 在网卡芯片上的程序，以下简称【F】            |
| 固件生成工具         |        | 基础配置相关，PCI 等，以下简称【T】          |
| linux/windows driver |        | 驱动，以下简称【D】                          |

## 二、适配平台

适用于网迅芯片型号

```bash
WX1860A4*、WX1860A2*、WX1860A1*、WX1860AL*
```
## 三、新增功能

- 【U】支持龙芯平台。

- 【U】支持申威平台。

- 【U】支持M88E1512和YT8521S。

## 四、 问题修复 & 优化

- 【F】AMI BMC 收到网卡返回fw_name不匹配问题修复。

- 【F】OEM功能增加对marvell 88e1512 phy LED闪烁频率的配置

- 【F】修复日志输出时固件生成日期显示错误的问题。

- 【F】优化：1）phy初始化前做lan reset操作

  ​	     2）删减efuse相关日志，忽略对phy page 0xa43及Regeister 26的读操作，避免与驱动抢page。

  ​	     3）add eee disable && disable eth green
  
- 【F】规避mbox消息触发固件复位问题

- 【U】删除phy重配置代码，UNDI驱动加载过程中不会做任何phy配置。

- 【U】修复寄存器配置过程中等待时间错误问题。

- 【U】支持客户定制svid ssid

- 【L】支持客户定制svid ssid

- 【T】支持客户定制svid ssid 的img

## 五、已知问题

- 【U】yt phy的固件不支持pxe启动，不能link up。


#############################################################

# 网迅千兆网卡固件10017

--------------

## 一、版本说明

网卡固件（image）版本： 10017

发布时间：2021年12月20日

内部组件版本：

| 内部组件             | 版本号 | 补充说明                                     |
| -------------------- | ------ | -------------------------------------------- |
| PXE-UEFI: UNDI       | v1.3.5 | 用于支持UEFI方式PXE启动 UNDI，以下简称 【U】 |
| PXE-BIOS: Legacy     | v1.1.2 | 用于支持Legacy方式PXE启动，以下简称 【L】    |
| FW                   | v1.4.0 | 在网卡芯片上的程序，以下简称【F】            |
| 固件生成工具         |        | 基础配置相关，PCI 等，以下简称【T】          |
| linux/windows driver |        | 驱动，以下简称【D】                          |

## 二、适配平台

适用于网迅芯片型号

```bash
WX1860A4*、WX1860A2*、WX1860A1*、WX1860AL*
```
## 三、新增功能

- 【F】【U】新增网口禁用功能，注：undi驱动匹配版本为“disable intf 9.1.2 ”
- 【F】支持用户对OEM LED进行定制，支持以下类型phy : yt8521s phy、mv1512 phy、Inner phy。
- 【F】支持用户对GPIO引脚进行定制。

## 四、 问题修复 & 优化

- 【F】修复mbox 命令处理，相关RTOS内核接口调用错误
- 【F】优化了串口下查看历史命令功能
- 【F】bmc channel_id兼容性优化
- 【F】修复了编译错误问题
- 【F】修复了xmodem协议选择crc/校验和错误问题
- 【F】efuse backup鲁棒性提升
- 【F】减少公共代码段的堆大小
- 【F】phy兼容性优化  注：leyan 88e1512_sfi(0x50)、leyan yt8521(0x70)
- 【F】新增sub sys id 0x51、0x52, marvell phy mode 相关。
- 【F】 新增sub sys id 0x61、0x62、0x64   ——恒为定制。
- 【F】 efuse 及网口禁用地址更改。
- 【F】修复ami bmc ping不通的问题（用户绑定厂商名导致）。
- 【U】禁用中断，改为POLLING模式，删除不必要的分配ISB内存的动作。
- 【U】修改DID0109设备名显示为WX1860-LC。
- 【L】add kr support autoneg off
- 【T】修改网口禁用copy addr 0xfe000->0xfd000
- 【T】所有固件类型都使用同一个fw.bin
- 【T】增加gen chkusm and time in 0xfffd0 - 0xfffd4

## 五、已知问题

无


############################################################


# 网迅千兆网卡固件10016

--------------

## 一、版本说明

网卡固件（image）版本： 10016

发布时间：2021年7月20日

内部组件版本：

| 内部组件             | 版本号 | 补充说明                                     |
| -------------------- | ------ | -------------------------------------------- |
| PXE-UEFI: UNDI       | v1.3.3 | 用于支持UEFI方式PXE启动 UNDI，以下简称 【U】 |
| PXE-BIOS: Legacy     |        | 用于支持Legacy方式PXE启动，以下简称 【L】    |
| FW                   | v1.3.5 | 在网卡芯片上的程序，以下简称【F】            |
| 固件生成工具         |        | 基础配置相关，PCI 等，以下简称【T】          |
| linux/windows driver |        | 驱动，以下简称【D】                          |

## 二、适配平台

适用于网迅芯片型号

```bash
WX1860A4*、WX1860A2*、WX1860A1*、WX1860AL*
```
## 三、新增功能

## 四、 问题修复 & 优化

- 【F】优化WOL实现方案
  - 纯硬件实现 wol parser 鲁棒性提升
  - 修复B版本，仅WOL only版本固件，关机后无法唤醒问题。 
- 【F】 BMC -> LAN 链路，支持FC等非常用包透传。
- 【D】【F】极限距离下，信号不稳定问题，驱动复位lan口导致efuse校准失效问题;(cmd 0xF0)
- 【F】 PHY相关
  - 增加 YT phy 类型，单独管理
  -  修复未识别的PHY类型，驱动切换速率异常问题
- 【F】 NCSI相关
  - 增加cmd default channel: 0x1F 支持；
  - 增加SN号获取，OEM cmd 0x50;
  - 增加FW版本号获取
  - NCSI cmd 包解流程析优化
- 【F】 新增phy类型支持：裕泰phy类型。支持直连FPGA应用;
- 【F】 增加自恢复机制（硬件看门狗）
- 【F】 非标卡固件，增加MNG保护，避免因为驱动复位导致异常。
- ~~【F】基础功能优化：rtos 升级，FIFO管理，event机制，支持ucmd， scmd， #打头注释，增加读长度限制等。
- 【F】修复BMC recovery机制撞随机数导致无限重启问题 （仅极少数芯片）
- 【F】规避 power circle 极低概率出现跑飞问题
- 【U】修复部分场景下IPV6不通问题
- 【U】修复在部分BIOS中网卡设置相关的帮助界面换行显示错乱问题
- 【T】增加VPD自定义显示,VPD长度（96字节）和相关算法，
    - VPD显示包括：芯片型号，是否支持NCSI,WOL，PXE是否是arm版本。


## 五、已知问题

无

###########################################################

# 网迅千兆网卡固件10015

--------------

## 一、版本说明

网卡固件（image）版本： 10015

发布时间：2021年3月22日

内部组件版本：

| 内部组件         | 版本号 | 补充说明                                     |
| ---------------- | ------ | -------------------------------------------- |
| PXE-UEFI: UNDI    |   v1.3.1     | 用于支持UEFI方式PXE启动 UNDI，以下简称 【U】 |
| PXE-BIOS: Legacy |    v1.1.0    | 用于支持Legacy方式PXE启动，以下简称 【L】    |
| FW               | v1.2.0 | 在网卡芯片上的程序，以下简称【F】            |
| 固件生成工具     |        | 基础配置相关，PCI 等，以下简称【T】          |

## 二、适配平台

适用于网迅芯片型号

```bash
WX1860A4*、WX1860A2*、WX1860A1*、WX1860AL*
```
## 三、新增功能

- 【F】合入 flash 保护功能，写或擦除需解锁。 对应烧录工具也需要配套
- 【F】BMC pause frame 透传 到 lan 口功能

## 四、 问题修复 

- 【F】增强固件鲁棒性，如 arp 攻击
- 【F】B版芯片兼容
- 【F】优化 wol pkt filter，提升过滤效率
- 【F】修复有概率串口rx无响应问题
- 【F】兼容性修改，长城 BMC拔掉网线后，重新插入不进行配置网络，导致网络断开问题。仅断开软件链路，物理链路保持，再次插入自动恢复连接。
- 【F】解决WOL wakeup引脚强上拉，导致其它网卡无法拉低wakeup 引脚问题，改为默认为输入状态。
- 【F】解决特定条件下 第一个WOL magic package 无响应问题。
- 【F】规避efuse因电路设计不合理导致被窜改问题（phy efuse backup）
- 【U】在hii界面增加wol开关显示

## 五、已知问题

暂无
